Jassif Team Institution

What Does it Mean to Publish a Package?

पैकेज प्रकाशित करने का अर्थ है अपने Node.js मॉड्यूल या प्रोजेक्ट को npm रजिस्ट्री के माध्यम से स्थापित करने और उपयोग करने के लिए दूसरों के लिए उपलब्ध कराना।

ओपन सोर्स लाइब्रेरी और टूल इस तरह से Node.js समुदाय के साथ साझा किए जाते हैं।

जब आप कोई संग्रह प्रकाशित करते हैं, तो वहnpm install your-package-nameउपयोगकर्ता किसी के भी द्वारा इंस्टॉल करने योग्य हो जाता है।

Preparing Your Package

1. पैकेज प्रारंभ करें

एक नई निर्देशिका बनाएं और अपना संग्रह प्रारंभ करें:

mkdir my-package
cd my-package
npm init -y

2. आवश्यक फ़ाइलें

एक पैकेज में ये महत्वपूर्ण फ़ाइलें होनी चाहिए:

3. Package.json Essentials

सुनिश्चित करें कि आपके package.json में ये न्यूनतम फ़ील्ड शामिल हैं:

{
  "name": "your-package-name",
  "version": "1.0.0",
  "description": "A brief description of your package",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": ["keyword1", "keyword2"],
  "author": "Your Name ",
  "license": "MIT"
}

Creating an npm Account

npm login

npm whoami

Publishing Your Package

npm view <package-name>

# In your package directory
npm link

# In another project directory
npm link <package-name>

# First, make sure you're in the right directory
cd path/to/your/package

# Publish to the public npm registry
npm publish

npm publish --tag beta

npm publish --access public

Updating Your Package

1. संस्करण संख्या अद्यतन करें

अपने पैकेज संस्करण को अद्यतन करने के लिए सिमेंटिक संस्करण प्रबंधन (सेमवीर) का उपयोग करें:

npm version patch

npm version minor

npm version major

2. परिवर्तन लॉग अद्यतन करें

इस संस्करण में परिवर्तनों का दस्तावेजीकरण करने के लिए अपने CHANGELOG.md को अपडेट करें।

3. अद्यतन जारी करें

npm publish

4. आउटपुट को चिह्नित करें (वैकल्पिक)

यदि आप Git का उपयोग कर रहे हैं, तो रिलीज़ के लिए एक टैग बनाएं:

git tag -a v1.0.0 -m "Initial release"
git push origin v1.0.0

Managing Published Packages

# Unpublish a specific version
npm unpublish <package-name>@<version>

# Unpublish the entire package (only works within 72 hours of publishing)
npm unpublish <package-name> --force

# Deprecate a specific version
npm deprecate <package-name>@<version> "message"

# Example
npx deprecate my-package@1.0.0 "This version is no longer maintained. Please upgrade to v2.0.0"

npm owner add <username> <package-name>

Best Practices

Summary

एनपीएम पर पैकेज प्रकाशित करना अपने कोड को Node.js समुदाय के साथ साझा करने का एक शानदार तरीका है।

यदि आप सर्वोत्तम प्रथाओं का पालन करते हुए अपने पैकेजों को अच्छी तरह से बनाए रखते हैं, तो आप मूल्यवान टूल का योगदान कर सकते हैं जिनका उपयोग अन्य लोग कर सकते हैं।

Exercise